<html>
<head><meta charset="utf-8"><title>How do I make a `note` come before `help`? · t-compiler/help · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/index.html">t-compiler/help</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html">How do I make a `note` come before `help`?</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="206193795"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206193795" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206193795">(Aug 06 2020 at 20:38)</a>:</h4>
<p>Right now I call <code>note()</code> then <code>span_suggestion()</code>. But the suggestion still comes first. Is there a way to re-order them?<br>
<a href="https://github.com/rust-lang/rust/pull/75079#discussion_r465453234">https://github.com/rust-lang/rust/pull/75079#discussion_r465453234</a></p>



<a name="206194236"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206194236" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206194236">(Aug 06 2020 at 20:42)</a>:</h4>
<p>I think you can use <code>span_note</code> and <code>help</code> instead</p>



<a name="206194295"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206194295" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206194295">(Aug 06 2020 at 20:42)</a>:</h4>
<p>let me try that, thanks :)</p>



<a name="206195850"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206195850" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206195850">(Aug 06 2020 at 20:56)</a>:</h4>
<p>hmm, then it's not a suggestion anymore, so you can't use <code>cargo fix</code></p>



<a name="206195931"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206195931" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206195931">(Aug 06 2020 at 20:57)</a>:</h4>
<p>let me try <code>help</code> and <code>span_suggestion</code></p>



<a name="206196097"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206196097" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206196097">(Aug 06 2020 at 20:59)</a>:</h4>
<p>nope</p>
<div class="codehilite"><pre><span></span><code>error: incompatible link kind for `f`
  --&gt; src/test/rustdoc-ui/intra-links-disambiguator-mismatch.rs:64:14
   |
64 | /// Link to [const@f]
   |              ^^^^^^^ help: to link to the function, use its disambiguator: `f()`
   |
   = help: this link resolved to a function, which is not a constant
</code></pre></div>



<a name="206196644"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206196644" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206196644">(Aug 06 2020 at 21:04)</a>:</h4>
<p>ah, you're using <code>span_suggestion</code>, I missed that sorry!<br>
so I think <code>span_suggestion</code> is still useful here? suggestions without span are unclear a bit</p>



<a name="206196722"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206196722" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206196722">(Aug 06 2020 at 21:05)</a>:</h4>
<p>right, but then it's the wrong order :(</p>



<a name="206196734"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206196734" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206196734">(Aug 06 2020 at 21:05)</a>:</h4>
<p>hmm, current message is fine for me, why do you want to re-order?</p>



<a name="206196751"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206196751" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206196751">(Aug 06 2020 at 21:05)</a>:</h4>
<p>because it doesn't say that it's a constant before changing it</p>



<a name="206196794"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206196794" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206196794">(Aug 06 2020 at 21:06)</a>:</h4>
<p>I guess it's not a big deal</p>



<a name="206196855"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206196855" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206196855">(Aug 06 2020 at 21:06)</a>:</h4>
<p>so adding <code>span_note</code> then <code>span_suggestion</code> works here?</p>



<a name="206197049"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206197049" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206197049">(Aug 06 2020 at 21:08)</a>:</h4>
<p>(rebuilding, one sec)</p>



<a name="206197115"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206197115" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206197115">(Aug 06 2020 at 21:09)</a>:</h4>
<p>nope</p>
<div class="codehilite"><pre><span></span><code>error: incompatible link kind for `f`
  --&gt; src/test/rustdoc-ui/intra-links-disambiguator-mismatch.rs:64:14
   |
64 | /// Link to [const@f]
   |              ^^^^^^^ help: to link to the function, use its disambiguator: `f()`
   |
note: this link resolved to a function, which is not a constant
  --&gt; src/test/rustdoc-ui/intra-links-disambiguator-mismatch.rs:64:14
   |
64 | /// Link to [const@f]
   |              ^^^^^^^
</code></pre></div>



<a name="206197132"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206197132" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206197132">(Aug 06 2020 at 21:09)</a>:</h4>
<p>and it also prints the span twice which is slightly less clear</p>



<a name="206197153"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206197153" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206197153">(Aug 06 2020 at 21:09)</a>:</h4>
<p>I'll just keep it as-is</p>



<a name="206197422"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206197422" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206197422">(Aug 06 2020 at 21:11)</a>:</h4>
<p>ugh, sorry I couldn't help you :(</p>



<a name="206197524"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206197524" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206197524">(Aug 06 2020 at 21:12)</a>:</h4>
<p>it's ok, it still looks decent :)</p>



<a name="206197541"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206197541" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206197541">(Aug 06 2020 at 21:12)</a>:</h4>
<p>I spent a long time on it last night haha <a href="https://github.com/rust-lang/rust/pull/75079#discussion_r465452985">https://github.com/rust-lang/rust/pull/75079#discussion_r465452985</a></p>



<a name="206636840"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206636840" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206636840">(Aug 11 2020 at 22:05)</a>:</h4>
<p><span class="user-mention" data-user-id="232545">@Joshua Nelson</span> Could you extend the actual error message to say something like <code>incompatible link kind for `f` (function, not const)</code>?</p>



<a name="206639028"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206639028" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206639028">(Aug 11 2020 at 22:32)</a>:</h4>
<p>Probably, I was just going to let it go though haha</p>



<a name="206657465"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/182449-t-compiler/help/topic/How%20do%20I%20make%20a%20%60note%60%20come%20before%20%60help%60%3F/near/206657465" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/182449-t-compiler/help/topic/How.20do.20I.20make.20a.20.60note.60.20come.20before.20.60help.60.3F.html#206657465">(Aug 12 2020 at 03:49)</a>:</h4>
<p>I really like the amount of effort that Rust goes to to make clear error messages, and I appreciated the effort you were going to, so I figured I'd try to find a solution. ;)</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>